package com.xujie.sportsmeeting.service;

import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.xujie.sportsmeeting.entity.SystemNotice;

import java.util.List;

/**
 * 系统公告服务接口
 */
public interface SystemNoticeService extends IService<SystemNotice> {

    /**
     * 发布公告
     */
    boolean publishNotice(SystemNotice notice);

    /**
     * 撤回公告
     */
    boolean withdrawNotice(Long noticeId);

    /**
     * 置顶/取消置顶公告
     */
    boolean setTopNotice(Long noticeId, Integer isTop);

    /**
     * 获取用户可见的公告列表
     */
    Page<SystemNotice> getUserNotices(Long userId, Integer current, Integer size, 
                                     Integer noticeType, String keyword);

    /**
     * 获取管理员公告列表
     */
    Page<SystemNotice> getAdminNotices(Integer current, Integer size, 
                                      Integer noticeType, Integer publishStatus, String keyword);

    /**
     * 根据目标用户类型获取公告
     */
    List<SystemNotice> getNoticesByTargetType(Integer targetUserType);

    /**
     * 获取置顶公告
     */
    List<SystemNotice> getTopNotices();

    /**
     * 获取最新公告
     */
    List<SystemNotice> getLatestNotices(Integer limit);

    /**
     * 统计未读公告数量
     */
    Long countUnreadNotices(Long userId);

    /**
     * 检查公告是否有效
     */
    boolean isNoticeValid(SystemNotice notice);

    /**
     * 增加阅读次数
     */
    boolean increaseReadCount(Long noticeId);

    /**
     * 获取公告详情（包含阅读状态）
     */
    SystemNotice getNoticeDetail(Long noticeId, Long userId);
}
